Determining Movie Creation and Modification Time2

The Movie Toolbox maintains two timestamps in every movie, track, and media. One timestamp, the creation date, indicates the date and time when the item was created. The other, the modification date, contains the date and time when the item was last changed and saved. The timestamp value is in the same format as Macintosh file system creation and modification times; that is, the timestamp indicates the number of seconds since midnight, January 1, 1904.

The Movie Toolbox provides a number of functions that allow your application to retrieve the creation and modification date information from movies, tracks, and media structures. This section describes those functions.

You can use the GetMovieCreationTime and GetMovieModificationTime functions to work with movie creation and modification dates.

You can use the GetTrackCreationTime and GetTrackModificationTime functions to retrieve a track's creation and modification dates.

Your application can call the GetMediaCreationTime and GetMediaModificationTime functions to get a media's creation and modification dates.

GetMovieCreationTime

The GetMovieCreationTime function returns a long integer that contains the movie's creation date and time information.



 
pascal unsigned long GetMovieCreationTime (Movie theMovie);

theMovie: Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie , NewMovieFromFile , and NewMovieFromHandle (described on NewMovie , NewMovieFromFile , and NewMovieFromHandle , respectively).

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

GetMovieModificationTime

The GetMovieModificationTime function returns a movie's modification date.



 
pascal unsigned long GetMovieModificationTime (Movie theMovie);

theMovie: Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie , NewMovieFromFile , and NewMovieFromHandle (described on NewMovie , NewMovieFromFile , and NewMovieFromHandle , respectively).

DESCRIPTION

The GetMovieModificationTime function returns a long integer that contains the movie's modification date and time information.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

GetTrackCreationTime

The GetTrackCreationTime function returns a track's creation date.



 
pascal unsigned long GetTrackCreationTime (Track theTrack);

theTrack: Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on NewMovieTrack and GetMovieTrack , respectively).

DESCRIPTION

The GetTrackCreationTime function returns a long integer that contains the track's creation date and time information.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

GetTrackModificationTime

The GetTrackModificationTime function returns a track's modification date.



 
pascal unsigned long GetTrackModificationTime (Track theTrack);

theTrack: Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on NewMovieTrack and GetMovieTrack , respectively).

DESCRIPTION

The GetTrackModificationTime function returns a long integer that contains the track's modification date and time information.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

GetMediaCreationTime

The GetMediaCreationTime function returns the creation date stored in the media.



 
pascal unsigned long GetMediaCreationTime (Media theMedia);

theMedia: Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on NewTrackMedia and GetTrackMedia , respectively).

DESCRIPTION

The GetMediaCreationTime function returns a long integer that contains the media's creation date and time information.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid

GetMediaModificationTime

The GetMediaModificationTime function returns a media's modification date.



 
pascal unsigned long GetMediaModificationTime (Media theMedia);

theMedia: Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on NewTrackMedia and GetTrackMedia , respectively).

DESCRIPTION

The GetMediaModificationTime function returns a long integer that contains the media's modification date and time information.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid